home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / lparser3 / lviewer.txt < prev    next >
Encoding:
Text File  |  1994-02-01  |  9.6 KB  |  239 lines
  1. ┌─────────┬────────────────────────────────┬───────────────────────────────┐
  2. │ Name:   │ DATA FILE VIEWER               │ (C) RenderStar Technology BV. │
  3. ├─────────┼────────────────────────────────┼──────────┬───────┬────────────┤
  4. │ Author: │ Laurens J. Lapre               │ Version: │  3.0  │ 1994-01-31 │
  5. ├─────────┴────────────────────────────────┴──────────┴───────┴────────────┤
  6. │ RenderStar Technology BV, Keizersgracht 448                              │
  7. │ 1016 GD Amsterdam, the Netherlands                                       │
  8. │ Fax (+31) 20 622 4939                                                    │
  9. ├─────────┬─────────────────────┬───────────────────┬──────────────────────┤
  10. │ Email:  │ 2:283/203.8 fidonet │ 'Lj Lapre' PCGnet │  ljlapre@hacktic.nl  │
  11. └─────────┴─────────────────────┴───────────────────┴──────────────────────┘
  12.  
  13.  
  14. Disclaimer :
  15. ──────────────────────────────────────────────────────────────────────────── 
  16. This software is free and may be freely distributed, but is copyrighted by 
  17. the company RenderStar Technology BV. This software is provided as is 
  18. without any guarantees. The author and company assume no liability for 
  19. damages, direct or consequential, which may result from the use of this 
  20. software. The 'lviewer.exe' file may not be used as part of any commercial 
  21. package without the explicit written consent of the author or company.
  22.  
  23.  
  24. General :
  25. ──────────────────────────────────────────────────────────────────────────── 
  26. This program is meant to be used together with the LPARSER program. It can 
  27. read and display to the screen the default output.VOL files generated by 
  28. the lparser.exe. Use it like this :
  29.  
  30. lparser lsys00
  31. lviewer output
  32.  
  33. It can also be used to quick preview the ascii based RAW and RAY files. The 
  34. ARE-24 POL and the 3D Studio 3DS binary files can also be viewed directly.
  35.  
  36. You will get some information about the loaded object and it will bring you 
  37. into a standard VGA 640x480 16 color screen. Here you can rotate the object, 
  38. zoom in/out and pan. For key usage see the Keys section. The lviewer can 
  39. handle very large models. It has a simple hidden polygon solver. Forms with a 
  40. lot of small polygons will 'hide' better. So try running the lparser with 
  41. '-x ball' and try the other additional base objects.
  42.  
  43. The keys can be operated directly. You don't have to wait for the wire-frame 
  44. redraw to finish in the main window but the side windows will have to be 
  45. drawn once during startup. The 'speed' with which you can move through the 
  46. model thus depends on the setting of your keybord repeat and the speed of 
  47. your graphics board.
  48.  
  49. When you enter the view screen you will see a box surrounding the object and 
  50. some additional elements like a cross and XYZ-axis. The additional 3 side 
  51. views are drawn from the viewpoint of possitive z-axis, x-axis and y-axis 
  52. respectively. When moving around through the model these views will help you 
  53. orient yourself. 
  54.  
  55. The current up direction in the main viewer will be the lightblue line in 
  56. the side views. The right direction will be darkblue, the front direction 
  57. green. The small yellow ball is where you next location will be if you move 
  58. the camera forward. The red circle is where you are at now. A 'reminder' of 
  59. all this can be found in the bottom left of the main view window.
  60.  
  61. The lviewer.exe is a protected mode program using the royalty free Rational 
  62. dos-extender (dos4gw.exe) supplied with Watcom. It needs a 386/387 or 486 
  63. with 4meg ram.
  64.  
  65. Standard VGA screen grabbers can be used to grab the image from the screen.
  66.  
  67.  
  68. Execute like this :
  69. ──────────────────────────────────────────────────────────────────────────── 
  70. lviewer [options] [name]
  71.  
  72. examples :
  73.  
  74. lviewer output         (takes .vol as default extension)
  75. lviewer plant.vol
  76. lviewer are24.pol
  77. lviewer trice.raw
  78. lviewer fract002.ray
  79. lviewer bird.3ds
  80.  
  81.  
  82. Formats can be :
  83. ──────────────────────────────────────────────────────────────────────────── 
  84. - LPARSER/RenderStar output file with the VOL extension. 
  85.     Described in the RenderStar Technical documentation.
  86.  
  87. - ARE-24/RenderStar temporary output file with the POL extension. 
  88.     Generated as part of an ARE-24 rendering in AutoCad-12/ADS.
  89.  
  90. - 3D Studio/AutoDesk binary format with the .3DS extension.
  91.  
  92. - FracTint *.RAY files when saved in RAW format. One coordiante per line 
  93.     format.    Select 3=RAW format and set BRIEF to YES. Format is like :
  94.  
  95.         x1 y1 z1
  96.         x2 y2 z2
  97.         x3 y3 z3
  98.  
  99.         x1 y1 z1
  100.         x2 y2 z2
  101.         x3 y3 z3
  102.         etc.
  103.  
  104. - RAW formated ascii file. One triangle per line format.
  105.     Format can be like :
  106.  
  107.         x1 y1 z1 x2 y2 z2 x3 y3 z3
  108.         x1 y1 z1 x2 y2 z2 x3 y3 z3
  109.         etc.
  110.  
  111.     Or like :
  112.  
  113.         NAME1
  114.         x1 y1 z1 x2 y2 z2 x3 y3 z3
  115.         x1 y1 z1 x2 y2 z2 x3 y3 z3
  116.         NAME2
  117.         x1 y1 z1 x2 y2 z2 x3 y3 z3
  118.         etc.
  119.  
  120.     Each time a name identifier is found the color number will be 
  121.     increased. Y and Z coordinates can be swapped with the -y option.
  122.  
  123.  
  124. Options :
  125. ──────────────────────────────────────────────────────────────────────────── 
  126. -y           use the Y-axis as up vector for RAW files
  127.  
  128. Normally the Z-axis is treated as up vector. (This is always the case with 
  129. VOL/POL/3DS files). With this option RAW files can be read in, which use the 
  130. Y-axis as up vector.
  131.  
  132. -s           run at 1024x768x16 SVGA mode
  133. -v           run at  800x600x16 SVGA mode
  134.  
  135. These modes will not be supported on all SVGA's. In this case use the default 
  136. VGA 640x480x16 mode.
  137.  
  138. -c            use color in side views
  139.  
  140. Normally the side views are drawn grey to allow you to see the position 
  141. feedback elements more clearly. Setting this option will draw the side views 
  142. in color. This is usefull for 'moving' through .RAY files.
  143.  
  144. -f            come up with main view
  145.  
  146. The main view will be drawn directly when starting up. The side views will 
  147. be skipped.
  148.  
  149.  
  150. Keys         General :
  151. ──────────────────────────────────────────────────────────────────────────── 
  152. [Page Up/Down]     These keys will allow you to zoom in and out with the cross 
  153. as center. The zoom is in 2d. The camera doesn't change it's location or 
  154. orientation in space. You will see the brown cone in the side views adjust at 
  155. the same time. What's inside the cone is visible on the main window.
  156.  
  157. [Insert]     Will scramble the drawing order of the data. This is usefull 
  158. when viewing bigger models. It will also turn off hidden polygon. Will only 
  159. work if there is still enough memory left free.
  160.  
  161. [Delete]     This will do a quick hidden polygon based on the painters 
  162. algorithm. It makes the form more visible but the solution is not perfect. 
  163. Will only work if there is still enough memory left free.
  164.  
  165. [Home]         This will bring up the starting configuration again in case 
  166. you get 'lost' and want to start afresh. It will also reset all viewing 
  167. parameters and toggles to their default start up value.
  168.  
  169. [F1]         This will write information about the model (bounding box) 
  170. and specifics of the current camera to the file 'info.txt' in the current 
  171. directory.
  172.  
  173. [F2]         This will write the current viewport in RenderStar rc1 format 
  174. in the file 'snapshot.rc1'.
  175.  
  176. [Escape]     Exit and back to DOS.
  177.  
  178.  
  179. Keys         Toggles :
  180. ──────────────────────────────────────────────────────────────────────────── 
  181. [Z]         This will toggle the Z-lock. If it's on the Z-axis will 
  182. always stay vertical and camera twist won't work. When the Z-lock it's off 
  183. you have full rotational control. The Z-axis will be drawn in yellow when 
  184. the Z-lock is active. By default the Z-lock is on.
  185.  
  186. [P]         This will toggle between drawing in polygons (default) and 
  187. drawing only one vertex per polygon. This can be usefull when working with 
  188. FracTint RAY files.
  189.  
  190. [C]         This will toggle between geometry and geometry with 
  191. additional viewing elements. Default is with additional viewing elements.
  192.  
  193. [Q]         This key in the lviewer allows you to cycle the main view 
  194. through all possible viewer setups. 
  195.  
  196.  
  197. Keys         Changing model orientation :
  198. ──────────────────────────────────────────────────────────────────────────── 
  199. [Cursor keys]     Rotate the model in the direction of the arrows around the 
  200. center of the model. The up/down keys will rotate the model round the 
  201. horizontal direction. The left/right keys will rotate the model around the 
  202. vertical direction. 
  203.  
  204.  
  205. Keys         Changing camera orientation :
  206. ──────────────────────────────────────────────────────────────────────────── 
  207. [Cntrl keys]     This rotates the camera round the observer in the directions 
  208. of the arrows. The up/down keys will rotate the camera round the horizontal 
  209. direction. The left/right keys will rotate the camera around the vertical 
  210. direction. 
  211.  
  212. [Alt keys]     Twist (roll) the camera counter-clockwise or clockwise.
  213.  
  214.  
  215. Keys         Changing camera location :
  216. ──────────────────────────────────────────────────────────────────────────── 
  217. [Numpad keys]     Move the camera in the direction of the arrows. The up/down 
  218. keys will move the camera along the vertical direction along the light blue 
  219. line in the side views. The left/right keys will move the camera across the 
  220. horizon in the direction of the dark blue line.
  221.  
  222. [Numpad + -]     Move the camera forward into the model or backward from the 
  223. model along the green line. The yellow ball is you next forward location.
  224.  
  225. [Numpad * /]     Increment and decrement the stepsize of the camera movement. 
  226. The position of the yellow ball will reflect the current stepsize
  227.  
  228.  
  229. Thanks to :
  230. ──────────────────────────────────────────────────────────────────────────── 
  231. C.J.van der Mark [2:283/203.11 fidonet, 9:580/203.11 PCGnet] for LV2POVID, 
  232. testing all versions and feedback.
  233.  
  234. Steve Anger for his 3DS reader/parser from 3ds2pov.
  235.  
  236. BBS Bennekom [2:283/203 fidonet, 9:580/203 PCGnet] for acting as go-between.
  237. ──────────────────────────────────────────────────────────────────────────── 
  238.  
  239.